docs: add Windows notes for Claude MCP HTTP setup#1859
Merged
SamMorrowDrums merged 4 commits intogithub:mainfrom Jan 26, 2026
Merged
docs: add Windows notes for Claude MCP HTTP setup#1859SamMorrowDrums merged 4 commits intogithub:mainfrom
SamMorrowDrums merged 4 commits intogithub:mainfrom
Conversation
Add a Windows/CLI note that `claude mcp add-json` may return "Invalid input" when adding an HTTP server, and point users to the legacy `claude mcp add --transport http ...` format. Also add a Windows (PowerShell) example for the legacy command when the CLI expects the MCP server name immediately after `claude mcp add`.
SamMorrowDrums
approved these changes
Jan 26, 2026
This was referenced Jan 26, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a short Windows/CLI note for the Claude Code CLI GitHub MCP setup when
claude mcp add-jsonreturns "Invalid input" for HTTP servers, and points users to the legacyclaude mcp add --transport http ...format. Also adds a PowerShell example for the legacy command when the CLI requires the MCP server name immediately afterclaude mcp add.Why
Windows users can hit
Invalid inputusing the documentedadd-jsonHTTP example, and can also hitmissing required argument 'name'if their CLI expects the server name immediately afteradd. Documenting the working fallback prevents a setup dead-end. Related Claude Code CLI issue: anthropics/claude-code#2341Fixes # (N/A)
What changed
add-jsonmay fail for HTTP and to use the legacymcp add --transport httpcommand insteadmissing required argument 'name'caseMCP impact
Prompts tested (tool changes only)
Security / limits
Tool renaming
deprecated_tool_aliases.goLint & tests
./script/lint(docs-only change)./script/test(docs-only change)Docs